This article will go through the steps required to set up a provided test project to test your custom XPages controls.

In this tutorial we will be using an example control project: com.example.greenbox, but same steps can be applied to other controls.
To follow this tutorial, import the com.example.greenbox project which can be found in the article's Attachments list.

Configuring Test Project

In the MANIFEST.MF in the test project, remove dependency on the com.example.xsp project
Add a new dependency for your control (in our case it's com.example.greenbox) so it looks like so:



In the project open WEB-INF/xsp.properties file
Change the dependency from com.example.library to your own (in our case it's com.example.greenbox.library)
It should look like so:Open config.properties in the test project package com.ibm.xsp.test.framework
Change the target.library and NamingConvention.package.prefix to your own control
(in our case it's com.example.greenbox.library and com.example.greenbox respectively). It should look like so:In the test project, open pages/simpleTestOfExampleControl.xsp
Change the XPage(prefix, namespace, tag) to use your own control. In our case it should look like so:Delete the contents of the gen folder in the test project.
Re-run the tests. Refresh the test project. gen folder should now contain generated Java Classes for the corresponding XPage above.

Before we continue to the next section, we need to fix a compile error in the ExamplePrintTagNamesAndProps.
In the test project, open ExamplePrintTagNamesAndProps.java from the xsp.example.test.version package.
Somewhere around line #22 change the following code to use your own control (in our case it's Greenbox Library).
Change from:You might need to organize your imports (Ctrl+Shift+O) to remove unused references to the old control.

Renaming Test Project

The sample test project was named to use with the example control. In this section we will go through the steps to rename the test project to use with our control.
For the tutorial purpose, we will be renaming the project to our Greenbox example control but same steps can applied to your own control.
We will start with renaming the project name and proceed to packages after.

Right click on the com.example.junit.tests project. Refactor -> Rename


Name the project to be com.example.greenbox.junit.tests


We are going to do the same for the packages in the test project.

Right click on the xsp.example.test package. Refactor -> Rename


Name the package to be xsp.example.greenbox.test


Now your test project structure should look like so:


The com.ibm.xsp.test.framework package should not be renamed as the name is required by the test framework.

Now we are going to rename Java Classes to reflect the the use of our control.
Right click on ExampleTestSuite.java in the com.example.greenbox.test package. Refactor -> Rename


Name it to be GreenboxTestSuite like so


Follow the same pattern for the remaining Java Classes: replacing Example[...] with Greenbox[...].
So that the test project structure looks like so:

Running Test Framework and Fixing Fails

Here we will run JUnit and fix failures one by one.

Running JUnit tests

Right-click on the GreenboxTestSuite Java Class in xsp.eample.greenbox.test package
Select Run As -> JUnit Test


The result will have 5 failures. Next, we are going to address the failures one at the time. So by the end of this tutorial, we will have a fully working test project.

GreenboxGroupReuseTest

This test fails with the following message:


Basically, this message is saying that there is an unused skip. As you can see the two messages are nearly identical.
This is because we were renaming the test project, but it still has references to the old project. Skips are used to ignore some failures which are not needed for the control to function.

1. Copy the error message by right-clicking on the contents of the Failure Trace pane and selecting Copy Trace like so:

2. Paste the error message somewhere in a text file and copy just the second line:


3. Since the test that failed is GreenboxGroupReuseTest, hit Ctrl+Shift+R to open Open Resource window. And type in the test name like so:

Open that file.

4. You will see the skips variable of String[] type. It will contain an old skip message. Replace with the one we copied earlier so it looks like so:

5. Rerun JUnit test. There will be one less failure(4 total).

GreenboxControlCategoryKnownTest

Same as with previous test, it fails with the "unused skip" message. So we are going to do the same here.



1. Copy the error message by right-clicking on the contents of the Failure Trace pane and selecting Copy Trace
2. Paste the error message somewhere in a text file and copy just the second line:

3. Since the test that failed is GreenboxControlCategoryKnownTest, hit Ctrl+Shift+R to open Open Resource window. And type in the test name
4. You will see the skips variable of String[] type. It will contain an old skip message. Replace with the one we copied earlier so it looks like so:

5. Rerun JUnit test. There will be one less failure(3 total).

GreenboxRoleAccessibilityTest

Again, it is the same type of fail as in two previous test failures.



1. Copy the error message by right-clicking on the contents of the Failure Trace pane and selecting Copy Trace
2. Paste the error message somewhere in a text file and copy just the second line:

3. Since the test that failed is GreenboxRoleAccessibilityTest, hit Ctrl+Shift+R to open Open Resource window. And type in the test name
4. You will see the skips variable of String[] type. It will contain an old skip message. Replace with the one we copied earlier so it looks like so:

5. Rerun JUnit test. There will be one less failure(2 total).

GreenboxSinceVersionsSetTest

Under this test, there will be 2 failures:



and



The first failure is about version mismatch. This is because we renamed our test project, but it's still referencing the old control and properties.
1. Right-click on the GreenboxPrintTagNamesAndProps from the xsp.example.greenbox.test.version package and run as Java Application like so:

This will print out an object with your control name and corresponding properties to the console. Like so:

Copy everything except the first line.
2. Open GreenboxSinceVersionLists Java Class from the xsp.exmaple.greenbox.test.version package.
Replace the already existing object with the one from above. So that it looks like this:

3. Rerun JUnit test. Your tests should pass now.

For more detailed information, see the [Advanced Tutorial].